ARIA: aria-level Attribut

Hierarchieebenen erscheinen in Überschriften, Bäumen, verschachtelten Rasterstrukturen, verschachtelten Registerkartenlisten und mehr. Wenn die DOM-Vorfahren die Ebene nicht genau wiedergeben, sollte das aria-level Attribut verwendet werden, um die hierarchischen Ebenen von Elementen innerhalb ihrer hierarchischen Strukturen zu definieren. Die Ebenen steigen mit der Tiefe. Der Wert für aria-level ist eine ganze Zahl, die größer oder gleich 1 ist.

In Bezug auf die Überschriften in einer Dokumentstruktur können Sie Überschriften der ersten Ebene, der zweiten Ebene, der dritten Ebene usw. haben. In Bäumen haben Sie das Wurzelelement, seine Kinder, die Kinder der Kinder (oder Enkelkinder) und so weiter.

Das aria-level Attribut macht die Hierarchie für unterstützende Technologien sichtbar, sodass sie den Nutzern mitgeteilt werden kann. Wie alle ARIA-Attribute hat es keinen Einfluss auf den User-Agent und damit keinen Einfluss auf die Bestimmung der Dokumentenstruktur durch den User-Agent.

Wenn die DOM-Vorfahren die Ebene genau wiedergeben, kann der User-Agent die Ebene eines Elements aus der Dokumentenstruktur berechnen, wodurch aria-level nicht nur überflüssig, sondern auch eine Gefahr für falsche Informationen darstellt. aria-level sollte wirklich nur verwendet werden, um eine explizite Angabe der Ebene zu liefern, wenn es nicht möglich ist, diese aus der Dokumentenstruktur zu berechnen. Testen Sie, ob dieses Attribut benötigt wird. Wenn der User-Agent die Ebene berechnen kann, ist es am besten, das aria-level Attribut wegzulassen.

Das aria-level Attribut ist ein erforderliches Attribut der heading Rolle, die unterstützenden Technologien anzeigt, dass das Element als Überschrift behandelt werden soll. <div role="heading" aria-level="1"> definiert das <div> als die Hauptüberschrift der Seite. Eine Überschrift der Ebene 2, definiert mit aria-level="2", wäre der erste Unterabschnitt, eine Ebene 3 ist ein Unterabschnitt davon, und so weiter.

<div role="heading" aria-level="3">Heading for this sub section</div>

Verwenden Sie besser die h1 bis h6 Elemente.

Im Fall eines treegrid wird aria-level auf Elementen unterstützt, die die Rolle row haben, nicht auf Elementen mit der Rolle gridcell. Reihen fungieren als Blattknoten innerhalb der vertikalen Ausrichtung des Rasters. Rasterzellen sind Blattknoten innerhalb der horizontalen Ausrichtung jeder Reihe. Aria-level wird nicht auf Zellen innerhalb von Reihen unterstützt. In Baumstrukturen wird das aria-level Attribut also auf das Element mit der Rolle row angewendet.

Wenn ein vollständiger Satz verfügbarer Knoten aufgrund dynamischen Ladens nicht im DOM vorhanden ist, während der Benutzer den Fokus bewegt oder durch den Baum scrollt, hat jeder Knoten aria-level, aria-setsize und aria-posinset hinzugefügt.

<integer>

Eine ganze Zahl, die größer oder gleich 1 ist

Element.ariaLevel

Die ariaLevel Eigenschaft, Teil der Element Schnittstelle, spiegelt den Wert des aria-level Attributs wider.

ElementInternals.ariaLevel

Die ariaLevel Eigenschaft, Teil der ElementInternals Schnittstelle, spiegelt den Wert des aria-level Attributs wider.

Verwendet in Rollen:

• associationlistitemkey
• comment
• heading
• row

• <h1> bis <h6>: Die HTML Sektion-Überschriftselemente (h1, h2, h3, h4, h5, und h6)